sequenceDiagram
    participant Client
    participant Endpoint as reset_key_spend_fn
    participant Validator as _validate_reset_spend_value
    participant AuthCheck as _check_proxy_or_team_admin_for_key
    participant DB as Prisma Client
    participant Cache as user_api_key_cache

    Client->>Endpoint: POST /key/{key}/reset_spend<br/>{reset_to: float}
    Endpoint->>Endpoint: Check prisma_client exists
    Endpoint->>Endpoint: Hash key if starts with "sk"
    Endpoint->>DB: find_unique(token, include budget_table)
    DB-->>Endpoint: Return key_in_db or None
    alt Key not found
        Endpoint-->>Client: 404 Key not found
    end
    Endpoint->>Validator: _validate_reset_spend_value(reset_to, key_in_db)
    Validator->>Validator: Check type, non-negative, <= current_spend
    Validator->>Validator: Check against max_budget (key & budget table)
    alt Validation fails
        Validator-->>Client: 400 Validation error
    end
    Validator-->>Endpoint: Return validated reset_to
    Endpoint->>AuthCheck: _check_proxy_or_team_admin_for_key
    AuthCheck->>AuthCheck: Check if PROXY_ADMIN
    alt Not PROXY_ADMIN
        AuthCheck->>DB: get_team_object(team_id)
        DB-->>AuthCheck: Return team_table
        AuthCheck->>AuthCheck: Check if user is team admin
    end
    alt Not authorized
        AuthCheck-->>Client: 403 Forbidden
    end
    AuthCheck-->>Endpoint: Authorization passed
    Endpoint->>DB: update(token, spend=reset_to)
    DB-->>Endpoint: Return updated_key
    Endpoint->>Cache: _delete_cache_key_object(hashed_token)
    Cache-->>Endpoint: Cache invalidated
    Endpoint-->>Client: 200 {spend, previous_spend, max_budget, etc.}